 Description

There are 6 steps involved in creating a setup file.  Your setup may not require the use of all steps. To begin you must open an existing project, or create a new project.  Use the menu items of  Project | Open or New, whichever you need. You may also use the drop down list on the main window to select a project.

Steps:

•	General

•	At the beginning

•	Files

•	INI/Registry

•	Shortcuts

•	At the end

A red star next to a field indicates that a value is required.

All projects are saved in the Projects subdirectory of Setup Generator and have an  .sgp file extension. The current project is saved automatically when you close the application or open another project.


 At the end

Finish Text - Text entered here will be shown at the end of the installation. To edit multiple lines of text, use the button to the right of this field.  Caution, do not enter too many lines of text or this field may appear empty.

Display Text File After Setup - If you want to display the text from an external file (such as readme.txt), enter the filename in this field.  This file will be opened using the default editor on the user's machine.

Show "View Readme" checkbox - Use this checkbox to indicate whether or not you want the user to have the option of viewing the text file (from the "Display Text File After Setup" field shown above).

Run after installation

The application file specified in the File Name field will be run after a successful installation.

Destination Directory - Indicate the path of the application file by selecting from default directories of: Windows, System, CD-ROM or the Installation path.

File Name - Enter an executable file name only.

Show "Run the installed application" checkbox - Select this checkbox to allow the user to cancel the running of the application.

See also:

Project Description


 Shortcuts

Shortcuts have the following parameters:

Shortcut name - Enter the name of the shortcut you are creating.

Destination Directory - Indicate the path of the shortcut file by selecting from default directories of: Windows, System, CD-ROM or the Installation path.

File Name - Enter the appropriate shortcut filename only.

Command Line Parameters - Enter any necessary command line parameters for the shortcut.  Note: If you use any paths in the command line parameters, you must put the path inside quotation marks.

See also:

Project Description


 INI/Registry

INI parameters

Predefined Path - Indicate the path of the INI file by selecting from default directories of: Windows, System, CD-ROM or the Installation path.

File Name - ini-file name. For example: myfile.ini.

Section - the section where a key will be written.

Key - key for a value.

Value - this is the value of the key.

Registry parameters

RootKey - select the appropriate choice from the drop down list.

Subkey - enter the subkey value.  Note: you must not begin this field with a "\".

Subkey Value Name and Type - enter the subkey value name select its type from the drop down list.

Value - enter the value you require.

Example for Binary type:

001000a8 => 0x00, 0x10, 0x00, 0xa8

See also:

Project Description


 Files

Source directory is the path to your application that you want to create an installation for. All files in the source directory it will be installed into the Installation Path. Source Directory must not be equal Output Directory.

You can add any files from other directories for installation into the Windows directory, System directory or Installation Path. To do so, use the file list.

The file list has the following parameters:

Source file(s) - Choose a file or files on your computer that you would like to add to your setup. You can choose a single file or multiple files ( using multiselect ). Also, you can use the wildcard.

For example: C:\my application\add-on\*.dll.

Predefined Path - You can choose a location for a selecting future file(s) from default directories of: Windows, System, CD ROM, or Installation directories.

If file exists in destination - Determines how the installation handles finding files of the same names in destination directories and subdirectories:

Skip - don't extract file.

Overwrite - overwrite file.

Overwrite if newer - overwrite file only if the packed file is newer.

Ask - ask user to confirm all overwriting

Ask if newer - ask user to confirm overwriting only if file being replaced is newer than the packed file.

See also:

Project Description


 At the beginning

Show Background - If left unchecked, the blue background window will not be visible.

Header Text (at left) - This string will be shown in the upper left-hand corner of the background window.

Footer Text (at right) - This string will be shown in the lower right-hand corner of the background window. It will be shown with a small font.

You may select the Font you wish to use for the Header Text.

Italic - if checked, the header text will be italic.

Bold - if checked, the header text will be bold.

License File Path - If you want to display license information as part of the installation process, supply the filename for the license agreement. (Example: License.txt)  Note: You must include the full path if the file is not in the Source Directory.

Comment Text - This text will be shown above the Installation Path edit box in the setup window. . To edit multiple lines of text, use the button to the right of this field.  Caution: Do not enter too many lines of text or the text may appear blank.

See also:

Project Description


 General

Destination directory  - The path where your install file will be saved.

Executable filename  - - The name of the file that will be created as the executable setup file. It must have an extension.

Example: setup.exe, install.exe, or myapp.exe

Program Name  - This is the name of your application. This is the important field.

This name will be used in the following places:

•	Default Destination Path. Such as: C:\Program Files\Your Program Name.

•	Uninstall Name.

•	Program Group Name.

Window Caption - The caption that will be shown in the setup windows.

Setup language - The language to be used in the installation messages.

Bitmap (Left-hand side) - This bitmap  will be shown in the left side of setup windows. The filename must include the full path if it does not reside in the Source Directory. Note: Smaller bitmap images work best.

Include Uninstaller - Check it if you want to have an Uninstall file created for your application.

See also:

Project Description


 Default macros

The values of the following predefined macros are determined during the setup process automatically or by your definition:

#setuppath#	Installation directory.
#winpath#	Windows directory.
#syspath#	Windows system directory.
#cdrompath#	Path to CDROM.
#date#	Returns the current date in the format defined in line 12 (12=) of the current language file (mylanguage.ln).  The date format is set using the letters m (month), d (day), y (two digit year) or yy (four digit year) as in the following example: Example:  d.m.yy -> 28.03.2000
#exepath#	Directory where setup.exe or ci2000.exe was executed (for actions before or after installation)
#temppath#	Temporary file directory. All files installed in this directory will be deleted after installation.
#outputpath#	Used only when creating a setup to specify the directory in which the setup will be created.
#curfile#	File currently being unpacked.
#dllname#	The full path name for a dynamic link library (DLL) used in the installation process.
#sysupdate#	Used to specify that system files must be updated.  If the value is 1 then a reboot is required and the user will be given the option to restart the machine.
#language#	The name of current language of installation.
#countparam#	The count of command line parameters in the current installation.
#cmdparam1# #cmdparam2# ...	Command line parameters in the current installation.
#i#	where i = the line number denoting a string resource defined in the language (.ln) file. The macro returns the string defined on that line.
#8.3anymacro#	In this case, macro #anymacro# will be taken and ShortPathName is called.


 Language Support

Setup Generator is shipped with support for several languages for both using the program and creating setups.  In addition you can add support for any other language (see below).  A library of string resources for each language is stored as a text file with the extension .ln in the Language subdirectory of the Setup Generator program directory.

Examples:

english.ln

french.ln

russian.ln

To create support for a new language:

•	Copy english.ln (or another language file) naming the new file as the new language name with the extension .ln.

•	Use any text editor to translate each line in the new file appropriately but preserve the line numbers exactly as they are.

•	Save the new file.

•	Test your translations by selecting the new language in the Options section of the program and review the captions and script editor.

The standard edition of Setup Generator is shipped with support for the following languages:

English

Chinese

French

German

Italian

Portuguese - BR

Russian

Spanish

Before attempting your own translation into another language, check our website for a full list of supported languages at http://www.gentee.com. You can download the latest versions of language resources and help files from this site.

Setup Generator and CreateInstall 2000 have the same language files.


 More features

Setup Generator has limited functionality. We are developing a Pro version of Setup Generator that will have the same user-friendly interface but it will contain many more features. Setup Generator Pro will be shareware.

If you need more functionality, try our advanced installer - CreateInstall 2000. You can get more information about it and download it from our site http://www.gentee.com. This installer more powerful than Setup Generator and it has many more features and Script language.


 Copyright

Setup Generator

Copyright (c) 1998-2000, Gentee, Inc.

Authors

•	Alexey Krivonogov  alexey@gentee.com

•	Alexandr Krivonogov  alexander@gentee.com

Email

info@gentee.com

WebSite

http://www.gentee.com

Additional information

Setup Generator does not use any third-part utilities. We have authored all versions using our own object technology and programming skills. Setup Generator has been programmed entirely in C Programming language and compiled using Microsoft Visual C++ 4.0 and 6.0.


 License Agreement

Setup Generator

SOFTWARE LICENSE AGREEMENT

LICENSE:

•	Setup Generator is freeware.

•	You may distribute your setups made with Setup Generator as you want.

•	You may use Setup Generator to make ANY setups for ANY number of products.

•	You may not alter this software in any way, including changing help and text files. You may modify only the strings in the .LN files located in the Language folder.

•	Setup Generator IS DISTRIBUTED "AS IS".  NO WARRANTY OF ANY KIND IS EXPRESSED OR IMPLIED. YOU USE IT AT YOUR OWN RISK. GENTEE, INC. WILL NOT BE LIABLE FOR DATA LOSS, DAMAGES, LOSS OF PROFITS OR ANY OTHER KIND OF LOSS WHILE USING OR MISUSING THIS SOFTWARE.

•	You are hereby licensed to make any number of backup copies of this free software and documentation. You can give the copy of the software to anyone or distribute the freeware version of the software providing that no additional fee is charged and the package files are not modified in any way.

•	All copyrights to Setup Generator are exclusively owned by Gentee, Inc..

•	Installing and using Setup Generator means the acceptance of these terms and conditions of the license. If you do not agree with the terms of this license you must remove Setup Generator files from your storage devices and cease to use the product.

Copyright 1998-2000 Gentee, Inc., All rights reserved.

Internet: http://www.gentee.com

Email: info@gentee.com


 About Setup Generator

Setup Generator is FREEWARE!

It is an installer and is designed for the creation of installations and setups. The output (setup) files are compact, easy to install, and include many options. You can create self-extracting archives, choose the parameters of the background and title, show license and readme text, run your dll and exe, make an Uninstall file, write to Registry, INI Files, write files to other directories, and create Menu group and icons.

Setup Generator is a simple installer and is very easy to use. Its purpose is to create a high quality self-extracting installation program for your applications.

Installation packages developed with Setup Generator may be distributed in any manner you wish (CD-ROM, floppies,WWW etc).

Please contact info@gentee.com if you would like to report bugs, grammar mistakes, or give your opinion about the program. Any comments are welcome.